1. 基本约定
1.1 接口通用参数
- req_enc=utf-8(必须放url后面,作为queryString)
- resp_enc=utf-8(必须放url后面,作为queryString)
1.2 调用规则
- 接口URL: 接口URL
- 调用方法:post/get/delete/put;一般情况下,查询数据用get方法;修改,删除,新增(包括上传,登录)数据用post方法
- 必填参数:参数名=xxx(多种情况用括号解析)
- 非必填参数:参数名=xxx(多种情况用括号解析)
- 说明文档参数:添加某特定参数可以直接看接口文档
- 是否需要登录:是, 否
- 返回格式:
- json
- html页面
- 缓存方式:
- 客户端
- HCS
- 客户端+HCS
- 缓存时间:缓存时间
- 返回结果:结果可能情况
1.3 mrobot接口规则
1.3.1 配置类型
1.3.2 自动代理类型
1.3.3 转换类型
1.3.4 非mrobot接口
- 规则:只要二级域名不是mrobot的接口一律不是mrobot接口,WEB开发小组是无法处理的,谢谢!
- 二级域名分类:
- 论坛相关:bbs, itbbs, piebbs
- 个人中心相关:my, passport2, bip
- 报价/产品库相关:price, product
- cms相关:www, www1
- 静态图片相关:img, img0~3, imgw, img0~3w, imgm, img0~3m
- 评论相关cmt
1.4 缓存
- 按照目前的系统结构设计,接口可能具备两套缓存
- hcs: 硬缓存系统,可通过http header中的X-HCS查看
- cache-control: 客户端缓存,可通过http header中的Cache-Control查看
2. 接口列表
2.1 图集相关
2.1.1 图集
备注:根据分类id请求图集列表(汽车网)
请求URL:http://agent1.pconline.com.cn:8941/pcautophoto/iphone_cate_json.jsp?id=85
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
id:图集类别id
2.1.2 图集列表
备注:图集列表
请求URL:http://mrobot.pcauto.com.cn/v2/photo/albums?modelId=8840
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:15分钟
请求参数:
modelId:车型id
请求后端URL:
http://agent1.pconline.com.cn:8941/pcautophoto/iphone_json.jsp?id=8840
请求后端参数:
modelId:车型id
2.1.3 推荐图集
备注:滚动到图集最后一张图后显示推荐图集,使用范围:汽车网app
请求URL:http://mrobot.pcauto.com.cn/v2/photo/recommendAlbums
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:15分钟
请求参数:无
返回参数:
[
{
"id": 130583,//图集id
"image": "http://i3.3conline.com/images/piclib/201305/23/batch/1/176477/1369277363528pbshbw5puy_medium.jpg",//图集封面图,尺寸待定
"photoCount": "10",//图片数
"title": "图集标题"
}
]
请求后端URL:
http://www.pcauto.com.cn/client/news/tghd/1401/intf2867.js
2.4 伪造顶踩数
备注:伪造顶踩数
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/hot?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1小时
请求参数:
pageNo:页码
pageSize:一页条数
请求后端URL:
http://www.pcauto.com.cn/app/bbs/1306/intf1847.html
2.2 论坛相关
2.2.1 帖子列表
备注:获取帖子列表,在原来的基础上添加置顶数据。置顶数据包含全站置顶和本版置顶。
置顶数据不给出所有置顶帖,只是分别从两者随机抽取一条数据出到接口,该数据flag字段的值恒为“荐”。
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/newForums/19139?pageNo=1&pageSize=19&orderby=postat
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:5分钟
请求参数:
论坛ID
pageNo:页码
pageSize:一页条数
orderby=postat:最新帖,orderby=replyat:最热帖,filter=pick:精华帖
请求后端URL:
http://bbs.pcauto.com.cn/rest/forums/19139?pageNo=1&pageSize=19&orderby=postat
2.2.2 帖子终端页
备注:获取文章或者帖子内容
请求URL:http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
帖子ID
pageNo:页码
pageSize:一页条数
picRule:获取图片的网络访问方式
authorId:作者ID
topicTemplate=4.0.0
app=pcautobrowser
size:字体大小
mode:阅读模式:无参数 白天;night 晚间
请求后端URL:
http://bbs.pcauto.com.cn/rest/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
请求后端参数:
pageNo:页码
pageSize:一页条数
picRule:获取图片的网络访问方式
authorId:作者ID
topicTemplate=4.0.0
app=pcautobrowser
size:字体大小
请求后端URL:
http://bbs.pcauto.com.cn/action/user/check_favorite.jsp //获取帖子在个人中心的收藏id
请求后端参数:
tid:4592911
2.2.3 论坛搜索
备注:论坛搜索
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/search?q=%E4%BA%BA&pageNo=9&pageSize=2
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
pageNo:页码
pageSize:每页行数
请求后端URL:
http://ks.pcauto.com.cn/search.jsp?appName=auto_bbs&return=id,login,title,forum,category,replycount,access,authorId,date,isPick,PhotosNum
&highlight=false&sort=time&returnType=json&q=%E4%BA%BA&perPage=2&pageNo=9
2.2.4 搜索贴子
备注:搜索贴子
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/search?q=che&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
pageNo:页码
pageSize:每页显示多少条
请求后端URL:
http://ks.pcauto.com.cn/search.jsp?appName=auto_bbs&return=id,login,title,forum,category,replycount,access,authorId,date,isPick,PhotosNum
&highlight=false&sort=time&returnType=json&q=che&perPage20&pageNo=1"
请求后端参数:
q:搜索关键字
pageNo:页数
pageSize:每页显示多少条
2.2 车型库相关
2.2.1 厂商车系列表
备注:根据厂商id返回该厂商所属品牌的车系列表
请求URL:http://mrobot.pcauto.com.cn/v3/price/getSerialListByManufacturerId/37
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1天
请求参数:
厂商id
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/serialGroup_list_by_manufacturer.jsp?manufacturerId=37
请求后端参数:
厂商id
2.2.2 车型列表
备注:车型列表
请求URL:http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/3524
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1天
请求参数:
车型id
请求后端url:
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=3524
请求后端参数:
车型id
2.2.3 精准选车条件
备注:精准选车条件
请求URL:http://mrobot.pcauto.com.cn/v3/price/models/criterionv36?v=4.0.0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:7天
请求参数:
1)变速器改成变速箱
2)所有条件加入“不限”选项
请求后端URL:
http://ks.pcauto.com.cn/search.jsp?q=state:1&returnType=json&appName=auto_price&perPage=0
&clustered=cluster_price,cluster_brand,cluster_std_displacement,cluster_kind,cluster_gearbox
2.2.4 精准选车-车系列表
备注:精准选车,获取车系列表接口
请求URL:http://mrobot.pcauto.com.cn/v2/price/models/search?queryJson={"cluster_kind":["紧凑型车"]}&pageNo=1&orderId=1&type=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
queryJson:查询条件
pageNo:页码
orderId:排序方式,1为最热门,2为最新,3为最便宜,4为最贵
type=1
请求后端URL:
http://ks.pcauto.com.cn/search.jsp?returnType=json&appName=auto_price&highlight=false&return=title,url,grp,grp_id,pic,yq_gl,price,
dmax_price,dmin_price,kind_name,gearbox,displacement,cubage&q=state:1&clusterQuery=(cluster_kind:紧凑型车)&sort=access&pageNo=1&perPage=1000
2.2.5 汽车网车系列表
备注:搜索接口,搜索某品牌下的车系
请求URL:http://mrobot.pcauto.com.cn/v3/price/models/search?keyword=大众&pageNo=1&pageSize=1000
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
keyword:查询条件
pageNo:页码
pageSize:一页条数
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/search_serial_group_list.jsp?pageNo=1&pageSize=1000&keyword=大众
请求后端参数:
keyword:查询条件
pageNo:页码
pageSize:一页条数
2.2.6 车系页
备注:车系终端页
请求URl:http://mrobot.pcauto.com.cn/v3/price/serialv40/3404?v=4.0.0&modelIds=19792
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:15分钟
请求参数:
车系id
v=4.0.0
modelIds:记录在客户端本地的已经加入对比的车型id列表
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=3404
请求后端参数:
车系id
2.2.7 经销商详情页
备注:经销商详情页。添加预约试驾和促销信息,促销信息来自网站已有的数据
请求URl:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&modelId=19792&seq=497120001&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&modelId2=19792
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:7天
请求参数:
areaId
modelId
seq
modelName
modelId2
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp&modelId=19792&pageSize=20&pageNo=1&mapType=2&areaId=1
http://price.pcauto.com.cn/interface/iphone/dealer_news_message.jsp
2.2.8 询底价页
备注:询底价页
请求URl:http://mrobot.pcauto.com.cn/v3/price/askprice?dealerId=49712&dealerName=%E5%B9%BF%E5%B7%9E%E6%96%87%E5%8D%8E%E7%A6%8F%E7%91%9E%E7%A6%8F%E7%89%B9+&modelId=19792&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/11/c3/14373198_14373198_1349942613212_120x90.jpg
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
dealerId
dealerName
modelId
modelName
url:车型图片链接
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://mrobot.pcauto.com.cn/v3/price/provinceCityList
2.2.9 车型终端页
备注:车型终端页
请求URl:http://mrobot.pcauto.com.cn/v3/price/modelsv40/27149?areaId=1&isCompared=0&app=pcautobrowser&v=4.1.0&night
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:1天
请求参数:
modelId:车型id
areaId
isCompared:车型id存在 1;不存在 0
app=pcautobrowser
v=4.1.0
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=27149
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp? //其他车型
http://mrobot.pcauto.com.cn/v3/price/allRegionList //地区
"http://price.pcauto.com.cn/interface/iphone/dealer_page_list.jsp?modelId="+modelId+"&pageSize=25&pageNo=1&mapType=2areaId = 1"
2.2.10 车系图片列表-部分
备注:车系图片列表-部分
请求URL:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=10059&fmt=json&pageSize=999&typeId=3
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:7天
请求参数:
serialGroupId:车系id
fmt:返回格式
pageSize:一页条数
typeId:部件:1为外观,2为内饰,3为其他细节,4为官方图
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?typeId=3&serialGroupId=10059&pageSize=999&pageNo=1
请求后端参数:
serialGroupId:车系id
pageSize:一页条数
pageNo:页数
typeId:部件:1为外观,2为内饰,3为其他细节,4为官方图
2.2.11 预约驾车页
备注:预约驾车页
请求URL:http://mrobot.pcauto.com.cn/v3/price/testdriver/
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
dealerId
dealerName
modelId
modelName
url:车型图片链接
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://mrobot.pcauto.com.cn/v3/price/provinceCityList
2.2.12 车型库首页热门车系列表&您可能对以下内容感兴趣
备注:1、车型库首页热门车系; 2、获取可能感兴趣内容
请求URL:http://mrobot.pcauto.com.cn/configs/pcauto_hot_serials
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:无
2.2.13 车型库品牌列表
备注:获取车型库品牌列表
请求URL:http://mrobot.pcauto.com.cn/v2/price/brands
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1天
请求参数:无
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/brand_list.jsp
2.2.14 通过品牌ID得到车系列表
备注:通过品牌ID得到车系列表
请求URL:http://mrobot.pcauto.com.cn/v3/price/getSerialListByBrandId/60
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:5分钟
请求参数:
品牌id
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?bid=60
请求后端参数:
品牌id
2.2.15 车主点评列表页
备注:获取某车系下的车主点评列表。接口为网页,点击网页中列表,跳转协议为:pcaction://pcauto-owner-review?modelId=${id}
请求URL:http://mrobot.pcauto.com.cn/v3/price/commentList/3404
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
车系id
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/commentList_by_sgid.jsp?sid=3404&pageNo=1&pageSize=10
请求后端参数:
sid:车系id(从id_0中取出)
pageNo:第几页
pageSize:每页显示多少条
2.2.16 车主点评终端页
备注:车主点评终端页
请求URL:http://mrobot.pcauto.com.cn/v3/price/commentDetail/19799
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
车型id
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/detail_comment_owner.jsp?mid=19799
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=19799
http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp //其他车型
请求后端参数:
mid:车型id(从id_0取出)
2.2.17 车型对比结果页
备注:车型对比页
请求URL:http://mrobot.pcauto.com.cn/v3/price/detailComparev40?id1=26138&id2=26139
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
id1:对比车量1
id2:对比车辆2
阅读模式:无参数 白天;night 晚间
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=26138
请求后端参数:
mid:对比车量1(从id1中取出)
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=26139
请求后端参数:
mid: 对比车辆2(从id2中取出)
2.2.18 车型相关文章
备注:车型相关文章,在原来的基础上添加顶踩数
请求URL:(获取某个车系下的文章列表)http://mrobot.pcauto.com.cn/v3/price/getNewestInfoListBySerialId/9010?pageNo=1&pageSize=20
(新闻文章列表) http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/3524?pageNo=1&pageSize=20
(评测文章列表)http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/3524?pageNo=1&pageSize=20
(导购文章列表)http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/3524?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1小时
请求参数:
serialId:车系id
ageNo:页码
pageSize:每页行数
请求后端URL:
http://price.pcauto.com.cn/interface/iphone/serialGroup_news.jsp?sid=9010
http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=+serial_ids:3524%20AND%20-channel_id:000001743%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path
&highlight=false&returnType=json&clusterQuery=cluster_channel:%D0%C2%CE%C5%B6%AF%CC%AC%20OR%20cluster_channel:%D0%C2%B3%B5%D7%CA%D1%B6
&sort=time:desc&mustquery=y&pageNo=1&perPage=20
http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=serial_ids:3524%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path&highlight=false
&returnType=json&clusterQuery=cluster_channel:%c6%c0%b2%e2%ce%c4%d5%c2&sort=time:desc&mustquery=y&pageNo=1&perPage=20
http://ks.pcauto.com.cn/search.jsp?appName=auto_cms_base&q=serial_ids:3524%20AND%20a_type:n&return=a_id,title,url,picUrl,date,path&highlight=false
&returnType=json&clusterQuery=cluster_channel:%b5%bc%b9%ba%ce%c4%d5%c2&sort=time:desc&mustquery=y&pageNo=1&perPage=20
请求后端参数:
serialId:车系id
pageNo:页码
perPage:每页行数
2.2.19 行情文章列表
备注:获取行情下的文章列表,在原来的基础上添加顶踩数
请求URL:http://mrobot.pcauto.com.cn/v3/price/getArticlePriceListBySerialId/3524?pageNo=1&pageSize=20&areaId=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1小时
请求参数:
serialId:车系id
ageNo:页码
pageSize:每页行数
areaId:地域id
请求后端URL:
http://ks.pcauto.com.cn/search.jsp
2.2.20 找车搜索关键字
备注:动态获取搜索关键字,由编辑在cms里维护
请求URL:http://mrobot.pcauto.com.cn/v3/price/modelsForSearch
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:15分钟
请求参数:无
返回参数:
{
"modelList": [
{
"id": 123,
"name": "蒙迪欧"
}
]
}
请求后端URL:
http://www.pcauto.com.cn/client/news/tghd/1401/intf2907.js
2.2.21 降价
备注:降价
请求URL:http://m.pcauto.com.cn/auto/market/r1.html?fromPcautoApp
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:2小时
请求参数:无
2.3 订阅相关
2.3.1 获取我的订阅
备注:我的订阅
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=1&pageNo=1&pageSize=1000
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
type:类型,此处为1
pageNo:页数
pageSize:每页显示多少条
请求后端URL:
http://my.pcauto.com.cn/intf/getCars.jsp?act=getCarSeries&pageNo=1&pageSize=1000
请求后端参数:
act:getCarSeries
pageNo:页数
pageSize:每页显示多少条
2.3.1 增加订阅
备注:增加订阅,说明:不支持批量添加
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save&req_enc=utf-8&resp_enc=utf-8&series=3054
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
series:车系id
返回参数:
{
carId = 518669;
carPic = "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1207/16/c4/12351711_12351711_1342426522843_270x202.jpg";
code = 1;
message = "保存数据成功";
}
2.3.2 删除订阅
备注:删除订阅,说明:不支持批量删除
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar&req_enc=utf-8&resp_enc=utf-8&carId=518663
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
carId:爱车id
返回参数:
{
code: 1,
message: "删除数据成功"
}
2.4 收藏相关
2.4.1 同步内容上传
备注:同步论坛收藏的内容
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/collectionUpload
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
json:需要上传的数据提交给该参数。
注:series,model为汽车网客户端专用,pieforum,pietopic为电脑客户端专用
返回参数:
{
“series”:{ //车系
“addList”:[123121,1111,2222,3333,566788], //新增车系id数组,此处的id即为同步下载接口中的seriesId,没有新增的车系该字段留空,即“addList”:[],如下同。
“deleteList”:[12356,6666,5555,32145] //删除车系数组,此处的id为爱车id,即为同步下载接口中seriesList下的id字段
},
"model":{ //车型
“addList”:[{serialId:111, modelId:111},{serialId:111, modelId:111}], //新增车型id数组,serialId为车系id,modelId为车型id
“deleteList”:[12356,6666,5555,32145] //删除车型数组,此id为爱车id,即为同步下载接口中modelList的id字段
},
“forum”:{ //论坛
“addList”:[123121,1111,2222,3333,566788], //新增论坛id数组,此处的id即为同步下载接口中的forumId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中forumList下的id字段
},
“topic”:{ //帖子
“addList”:[123121,1111,2222,3333,566788], //新增帖子id数组,此处的id即为同步下载接口中的topicId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中topicList下的id字段
},
“pieforum”:{ //论坛
“addList”:[123121,1111,2222,3333,566788], //新增论坛id数组,此处的id即为同步下载接口中的forumId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中forumList下的id字段
},
“pietopic”:{ //帖子
“addList”:[123121,1111,2222,3333,566788], //新增帖子id数组,此处的id即为同步下载接口中的topicId
“deleteList”:[12356,6666,5555,32145], //删除论坛数组,此id为收藏id,即为同步下载接口中topicList下的id字段
}
}
请求后端URL:
http://my.pcauto.com.cn/intf/modifyCar.jsp //同步我的爱车数据&同步车系
http://bbs.pcauto.com.cn/action/user/favorite.jsp //同步我的收藏数据
http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp //同步删除论坛版块
2.4.2 添加收藏的文章
备注:添加收藏的文章
请求URL:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=addFavorarticle
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
favorArticleId:文章id,如果要批量添加,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx
2.4.3 添加收藏的车型
备注:添加收藏的车型,说明:此接口不支持批量添加
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=save
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
series:车系id
model:车型id
2.4.4 添加收藏的帖子
备注:添加收藏的帖子
请求URL:http://bbs.pcauto.com.cn/action/user/favorite.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
tid:帖子id
2.4.5 删除收藏的文章
备注:删除收藏的文章
请求URL:http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=delFavorarticle
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
favorArticleId:文章id,如果要删除添加,id参数的拼接方式为,favorArticleId=xxxxx,xxxxx
2.4.6 删除收藏的车型
备注:添加删除的车型,说明:此接口不支持批量删除
请求URL:http://my.pcauto.com.cn/intf/modifyCar.jsp?act=delCar
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
carId:爱车id
2.4.7 删除收藏的帖子
备注:删除收藏的帖子
请求URL:http://bbs.pcauto.com.cn/action/user/favorite_delete.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
tid:帖子id,如果一次性要删除收藏的多条帖子,请拼接多个id参数,即:id=xxx&id=xxx
2.4.8 判断版块、帖子是否已经收藏
备注:判断版块、帖子是否已经收藏
请求URL:http://bbs.pcauto.com.cn/action/user/check_favorite.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
fid:版块id
tid:帖子id
返回参数:如果已经登陆并且版块或者帖子已经收藏,返回收藏id,否则返回-1
2.4.8 收藏夹信息---文章
备注:判断版块、帖子是否已经收藏
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteArticles?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
pageNo:页数
pageSize:每页显示多少条
请求后端URL:
http://my.pcauto.com.cn/intf/FavorArticle.jsp?act=getFavorarticle&pageNo= 1&pageSize=20
请求后端参数:
act:getFavorarticle
pageNo:页数
pageSize:每页显示多少条
2.4.9 收藏夹信息---车型
备注:收藏夹信息---车型
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getCars?type=0&pageNo=1&pageSize=20
HTTP请求方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
type:类型,此处为0
pageNo:页数
pageSize:每页显示多少条
请求后端URL:
http://my.pcauto.com.cn/intf/getCars.jsp?act=getCarModels&pageNo=1&pageSize=20
请求后端参数:
act:getCarModels
pageNo:页数
pageSize:每页显示多少条
2.4.10 收藏夹信息---帖子
备注:收藏夹信息---帖子
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getFavoriteTopics/826717?pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
用户id
pageNo:页数
pageSize:每页显示多少条
请求后端URL:
http://bbs.pcauto.com.cn/intf/user/_favTopics.jsp?userId=826717&pageSize=20&pageNo=1
请求后端参数:
userId:826717(从id_0取出)
pageNo:页数
pageSize:每页显示多少条
2.5 个人中心
2.5.1 我的帖子
备注:个人中心-我的帖子
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
filter:post|pick(post:回帖,pick:精华贴),缺省参数为主贴
pageNo:页码
pageSize:一页条数,默认20,最大500
maxLength
请求后端URL:
http://bbs.pcauto.com.cn/intf/user/_topics.jsp?userId=13128876&pageNo=1&pageSize=20&maxLength=20
请求后端参数:
userId:13128876(从id_0取出)
pageNo:页数
pageSize:每页显示多少条
maxLength:帖子内容显示最大长度
2.5.2 获取新消息数量
备注:获取个人中心的新消息的数量。提醒包含一下几种:1.我发的帖子,别人回帖;2.我发的回帖,别人回复;3.我发的文章评论,别人回复
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
请求后端URL:
http://bip.pcauto.com.cn/intf/message.jsp?act=getNumToJson&siteId=2&status=0
2.5.3 清零系统消息
备注:清零系统消息
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/setNewMsgState
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
messageType:1
typeIds:2004
请求后端URL:
http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=0&groupType=-1&pageNo=1&pageSize=200 //清理系统消息
http://bip.pcauto.com.cn/intf/message.jsp?act=find&siteId=2&status=0&groupType=-1&pageNo=1&pageSize=200 //清理私信
2.5.4 获取个人私信
备注:获取个人私信
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessage?pageSize=20&pageNo=1&userId=24286812
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
userId:对方的用户id
2.5.5 获取用户信息
备注:获取用户信息
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
uid:用户ID,如果没有此参数则返回当前用户信息
返回参数:
{
"image":头像
"isVip":是否认证车主
"level":用户级别
"name":用户名
"nickname":用户昵称
"serialId":认证车系ID
"serialName":认证车系名
"userId":用户ID
"friends":关注好友数
"fans":粉丝数
}
请求后端URL:
http://bbs.pcauto.com.cn/action/user/user_setting_json.jsp
http://bbs.pcauto.com.cn/plugin/vip/showCar.do //获取车主认证信息
http://bip.pcauto.com.cn/intf/focus.jsp //获取关注的好友数和粉丝数
2.5.6 获取回帖回复提醒内容
备注:获取回帖回复列表。说明:本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段;调用获取评论回复成功会清零这个接口的commentReplyCount字段
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
pageNo:页数
pageSize:每页显示多少条
请求后端URL:
http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2030,2031&noTemplate=true&pageNo=1&pageSize=20
请求后端参数:
pageNo:页数
pageSize:每页显示多少条
2.5.7 获取文章评论回复列表
备注:获取文章评论回复列表。说明:本接口和获取新消息的接口 http://trac.pc.com.cn/iphone/wiki/pcauto_4.0.0/interface#a2.6新消息 有相关联系。调用获取回帖成功会清零这个接口的forumReplyCount字段;调用获取评论回复成功会清零这个接口的commentReplyCount字段
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getTopicReplyReminds?pageSize=20&pageNo=1
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
common_session_id:用户登陆后获得的认证id
pageNo:页数
pageSize:每页显示多少条
返回参数:
{
"pageNo":1,
"pageSize":20,
"total":200,
"resultList": [
{
"id": 123123, //1和2时,为帖子id,为3时是文章id
"type": 1,//1回复主贴,2回复回帖,3回复文章评论
"face": "",//头像
"userName": "xxx",//昵称
"userId": 6546,
"replyToUserName":"xxx", // type为1时该字段有效。当用户A在我的主帖里回复了用户B,该字段返回用户B的昵称
"replyToUserId":123, //该字段返回的时id,其他同"reply-to-userName"
"noticeId":123,消息id(删除消息需用此字段)
"createAt": 1382582506000,
"toReply": "引用内容",
"content": "回复内容",
"topicId":123, // 如果这条回复是评论,则这是对应评论列表的主题id;如果是回复帖子,为0
"topicUrl":"" , // 如果这条回复是评论,则这是对应评论列表的主题url;如果是回复帖子,为空字符串
"title":"", // 帖子或者文章标题
"floorId":123 , // 该回复的楼层id,评论和帖子都用这个字段
"floor":123 // 该回复的楼层数,评论和帖子都用这个字段
}
]
}
ps:这接口内容有3种
1.我发的帖子,别人回帖
2.我发的回帖,别人回复
3.我发的文章评论,别人回复
请求后端URL:
http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2030,2031&noTemplate=true&pageNo=1&pageSize=20
请求后端参数:
pageNo:页数
pageSize:每页显示多少条
2.5.8 个人中心推广
备注:获取个人中心的推广内容,由编辑在cms里维护
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/personalExtend
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:15分钟
请求参数:无
返回参数:
{
"data": [
{
"title": "我是文字链",
"to-uri": "pcautobrowser://information-article/id"
}
]
}
请求后端URL:
http://www.pcauto.com.cn/client/news/tghd/1401/intf2868.js
2.5.9 修改昵称
备注:修改昵称
请求URL:http://my.pcauto.com.cn/intf/syncNickName.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
req_enc:UTF-8
resp_enc:UTF-8
nickName:昵称
act:save
返回参数:
{"code":0}表示成功, {"code":非0,"message":"提示"}
2.5.10 修改头像
备注:修改头像
请求URL:http://upc.pcauto.com.cn/upload_head.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:禁用缓存
缓存时间:无
请求参数:
二进制图片数据
返回参数:
成功:{retCode: 0} 失败:{retCode: xxx}
2.5.11 发私信接口
备注:发私信接口
请求URL:http://bip.pcauto.com.cn/intf/message.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId:用户ID
act=create
accountId:发送给某个用户
content:消息内容
captcha:验证码
req_enc:UTF-8
resp_enc:UTF-8
(说明:发送限制)
1.post
2.验证码
3.黑名单
4.邮箱绑定,该限制仅限於2012-01-01起注册的用户
5.发送频率 50次/ID/24H
6.白名单最多一次发送50个用户,非白名单则每次只能发一个
7.添加关键词库过滤
返回参数:
{code:0,message:"提示"}
2.5.12 收发私信列表
备注:收到与发出的私信列表
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList?type=1&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&siteId=2&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
type:私信类型(1 收到的私信; 0 发出的私信)
siteId:网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status:私信状态(-1为已读和未读,0表示未读,1表示已读)
pageNo:页码
pageSize:一页条数,默认20,最大500
common_session_id
req_enc:UTF-8
resp_enc:UTF-8
返回参数:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
content: 消息内容
createTime: 发送时间
status: 阅读状态
accountId: 用户ID
senderId: 发送者ID
receiverNickname:发送者昵称
receiverFace:头像
replyId: 回复ID
showStatus: 显示状态
}
}
请求后端URL:
http://bip.pcauto.com.cn/intf/message.jsp?act=find&siteId=2&status=-1&pageNo=1&pageSize=20
请求后端参数:
pageNo:页码
pageSize:一页条数,默认20,最大500
2.5.13 获取他人最新动态接口
备注:获取他人最新动态接口
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/newsfeed/31836836
HTTP请求方式:get
是否需要登录:是
返回格式:html页面
缓存方式:无
缓存时间:无
请求参数:
UID:用户ID
请求后端URL:
http://bip.pcauto.com.cn/intf/newsfeed.jsp?act=findMyNewsfeed&isWap=true&accountId=31836836&siteId=2&typeIds=2001,2003,2004&pageSize=20
2.5.14 个人中心 - 我的评论
备注:个人中心 - 我的评论
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/userCmtList/31836836
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
UID:用户ID
webSite:pcauto
返回参数:
{
"data": [
{
"articleId": 4003061,
"content": "很好的文章!!说不定哪天就用到了!!",
"createTime": 1394361427000,
"floor": 12,
"id": 26731760,
"ip": "192.168.239.90-113.64.110.39",
"nickname": "dufu163",
"replyRef": {
},
"status": 2,
"topicId": 13113197,
"topicTitle": "证照手续不用愁(3)驾驶证丢了怎么办?",
"topicUrl": "http://www.pcauto.com.cn/drivers/400/4003061.html",
"url": "http://cmt.pcauto.com.cn/topic/a0/r0/p1/ps20/t13113197.html"
}
],
"pageNo": 1,
"pageSize": 20,
"status": 0,
"total": 1,
"uid": 31836836
}
请求后端URL:
http://cmt.pcauto.com.cn/intf/uc_user_cmt.jsp?userId=31836836&webSite=pcauto&pageNo=1&pageSize=20
2.5.15 关注&取消关注
备注:关注&取消关注
请求URL:http://m.pcauto.com.cn/bip/intf/focus.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=add|delete(add:关注,delete:取消关注)
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
req_enc:UTF-8
resp_enc:UTF-8
common_session_id
返回参数:
{"code":0}成功
2.5.16 判断与某用户的关系
备注:判断与某用户的关系
请求URL:http://m.pcauto.com.cn/bip/intf/focus.jsp
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=isHisFocus
accountId=xxxxxx 当前用户ID
friendId=xxxxxx 关注用户ID
req_enc:UTF-8
resp_enc:UTF-8
common_session_id
返回参数:
0:没关注,1:关注,2:被关注,3:相互关注
2.5.17 获取系统消息
备注:获取系统消息
请求URL:http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&noTemplate=true&resp_enc=UTF-8&siteId=2&typeIds=2004&status=-1&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=find
siteId=网站ID(1是电脑网,2是汽车网,3是游戏网,4是女性网,5是亲子网,6是家居网)
status=-1(-1为已读和未读,0表示未读,1表示已读)
typeIds=2004
groupType=消息分组,默认全部,开发人员提供
status=0是未读,1是已读,默认-1是全部
startDate=开始时间
endDate=结束时间
beforeDay=在某个时间前
pageNo=页码
pageSize=一页条数,默认20,最大500
noTemplate=true不需要模板,false需要模板,默认是false
返回参数:
{
total: 总的条数
pageNo: 页码
pageCount: 页数
pageSize: 每页条数
resultList:{
id: 消息ID
type: { //消息类型
name: 消息类型名称
id: 消息分类ID
description: 描述
siteId: 网站ID
templateId: 模板ID
groupType: 分组ID
}
content: 模板内容
createTime: 发送消息时间戳
status: 状态
accountId: 接收消息人
siteId: 网站ID
typeId: 分类ID
senderId: 发送者ID
groupSend: 是否群发
groupType: 消息分组
resultText: 操作结果
}
2.5.18 获取爱车列表
备注:获取爱车列表
请求URL:http://my.pcauto.com.cn/intf/getCars.jsp
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act{
=getCars 获取该用户所有爱车;
=getCarSeries获取该用户的添加的车型;
=getCarModels获取该用户的添加的车系;
}
accountId = (不传此参数,将获取登录ID,);
pageNo = (次参数不传,则为默认为1,即第一页);
pageSize = (次参数不传,则为默认为20,最小为1,最大为100);
callback = (回调函数)
返回参数:
失败:{"code":-1,"message":""}
成功:{
"total":5,
"pageNo":1,
"pageCount":1,
"pageSize":20,
"resultList":[
"createTime":"2013-11-28 08:24:21",
"accountId":8749870,
"carSeriesId":4580,
"carModelId":0,
"updateTime":"2013-11-28 08:24:21",
"carPic":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/17/c2/28719139_1384678383261_270x202.jpg",
"brandId":932,
"buyPlaceId":0,
"id":270094,
"driveStatus":0,
"buyPlace":null,
"name":"残缺的F5",
"brand":" 长城汽车 ",
"carSeriesName":"哈弗H6"
]
}
注意:
用户须登录;
调用接口时需把common_session_id传过来;
因为act=getCars是旧接口,不能改动,所以没有做任何改变,没有分页,act=getCarSeries, act=getCarModels是新接口,可传分页参数,新旧接口返回json结构不一样。
2.5.19 收集推送token接口
备注:token数据放在passport2,赖子粼负责
请求URL:http://passport2.pconline.com.cn/passport2/api/mobilePushInfo.jsp
HTTP请求方式:post
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
act=addMobilePushInfo
deviceType=1//设备类型,1:iOS,2:android
token=xxx//推送token
返回参数:
{"code":0,"message":"数据已经插入"}
2.5.20 获取用户好友列表
备注:返回包括关注的好友和粉丝
请求URL: http://my.pcauto.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8
HTTP请求方式:get
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId:用户ID,如果没有改参数的话则返回当前用户的好友列表
act:findFocus为关注,findFocusBy为粉丝
pageNo:页码
pageSize:页长度
common_session_id
req_enc:UTF-8
resp_enc:UTF-8
返回参数:
{
"total":18,
"pageCount":2,
"pageNo":1,
"pageSize":20,
"resultList":[
{
"accountId":用户ID
"focusNum":关注好友数
"fanNum":粉丝数
"nickName":用户昵称
"image":头像
}
]
}
2.5.21 验证码接口
备注:验证码接口
请求URL:http://captcha.pcauto.com.cn/captcha/v.jpg
HTTP请求方式:get
是否需要登录:否
返回格式:
缓存方式:禁用缓存
缓存时间:无
请求参数:无
返回参数:
返回一张验证码图片
2.6 资讯
2.6.1 搜索资讯
备注:搜索资讯
请求URL:http://mrobot.pcauto.com.cn/v2/cms/search?q=che
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
请求后端URL:
http://ks.pcauto.com.cn/search.jsp?returnType=json&appName=auto_cms_base&clustered=cluster_channel,cluster_city
&return=id,date,url,title,summary_store,tag&search=title&highlight=false&q=filter:1+che&perPage=0
2.6.2 分类栏目资讯搜索
备注:搜索资讯
请求URL:http://mrobot.pcauto.com.cn/v2/cms/search?q=car&clusterQuery=(cluster_channel:新闻动态)
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
q:搜索关键字
clusterQuery=(cluster_channel:分类栏目)
请求后端URL:
http://ks.pcauto.com.cn/search.jsp?returnType=json&appName=auto_cms_base&clustered=cluster_channel,cluster_city&return=id,date,url,title,summary_store,tag
&search=title&highlight=false&q=filter:1+car&perPage=100&clusterQuery=(cluster_channel:新闻动态)
2.6.3 用户体验计划
备注:用户体验计划
请求URL:http://www.pconline.com.cn/sjzh/ued/app/auto/iphone/
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:15分钟
请求参数:无
2.6.4 栏目页topArticle增加楼层数和图集张数
备注:添加total字段;并且给所有栏目实现分页功能
请求URL:http://mrobot.pcauto.com.cn/v2/cms/channels/1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:5分钟
请求参数:
栏目ID
2.6.5 车系聚合页
备注:获取车系聚合页数据
请求URL:http://mrobot.pcauto.com.cn/v2/cms/serialMixedData/228?pageNo=1&pro=广东省&city=广州市&v=4.0.0
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:5分钟
请求参数:(说明:客户端获取http://whois.pconline.com.cn/ipJson.jsp?level=2的返回参数,作为本接口area参数的值请求本接口)
已经订阅的车系id
pageNo:页数
pageSize:每页显示多少条
pro:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro
city:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city
v=4.0.0
请求后端URL:
http://mrobot.pcauto.com.cn/v2/cms/serials/228?pro=广东省&city=广州市
请求后端参数:
pro:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro
city:城市,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city
2.6.5 文章终端页
备注:获取文章
请求URL:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=3.6.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0
HTTP请求方式:get
是否需要登录:否
返回格式:html页面
缓存方式:无
缓存时间:1小时
请求参数:
文章ID
articleTemplate=3.6.0
size:字体大小
app=pcautobrowser
picRule:请求网络方式:0 非wifi; 2 wifi访问
pageNo:页码
template:模板
channelId:栏目ID
serialId:车系ID
date:文章直播时间(说明:当参数template=live时,传递date,否则不传)
阅读模式:无参数 白天;night 晚间
请求后端URL:
helper_uri_articles_3?id=4147040
请求后端参数:
id:4147040(从id_0取出)
2.7 评论
2.7.1 获取文章最新评论楼层数
备注:获取文章最新评论楼层数
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/get_newest_floor?url=http://www.pcauto.com.cn/pingce/414/4147099.html
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
url:文章主题url
请求后端URL:
http://cmt.pcauto.com.cn/action/topic/get_data.jsp?url=http://www.pcauto.com.cn/pingce/414/4147099.html
请求后端参数:
url:文章主题url
2.7.2 获取评论
备注:获取文章评论
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/new_topics/13118127?articleId=4147040&reverse=0&pageNo=1&pageSize=20
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
topicId:主题ID
articleId:文章ID
reverse:排序方式:0 倒序; 1 正序
pageNo:页码
pageSize:每页行数
请求后端URL:
http://cmt.pcauto.com.cn/action/comment/list_new_json.jsp?tId=13118127&arch=0&reverse=0&pageSize=20
http://cmt.pcauto.com.cn/intf/tophot.jsp?tid=13118127
请求后端参数:
tid:主题ID(从id_0取出)
reverse:排序方式:0 倒序; 1 正序
pageSize:每页行数
2.7.3 顶评论
备注:顶评论
请求URL:http://cmt.pcauto.com.cn/action/comment/support_json.jsp?cid=26821494&sp=1
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
cid:评论ID
sp=1(顶数量+1)
2.7.4 回复文章评论
备注:回复文章评论
请求URL:http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
HTTP请求方式:post
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
topicId:主题ID
topicUrl:主题url
articleTitle:文章标题
content:回复内容
name:用户名
是否匿名:0 否
replyFloor:回复楼层
articleId:文章ID
2.7.5 车型降价信息
备注:获取某个车系下在售车型的降价信息
请求URL:http://mrobot.pcauto.com.cn/v3/price/getDepreciateModelBySerialId/3544?pageNo=1&pageSize=20&pro=广东省&city=广州市
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:1天
请求参数:
serialId:车系id
pageNo:第几页
pageSize:每页显示多少条
pro:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的pro
city:省份,截取从接口http://whois.pconline.com.cn/ipJson.jsp?level=2中返回的参数中的city
请求后端URL:
http://mrobot.pcauto.com.cn/v3/price/allRegionList //获取城市列表
http://price.pcauto.com.cn/interface/iphone/get_models_discount.jsp //定位到了某个具体的城市,获取该城市的数据
http://price.pcauto.com.cn/interface/iphone/get_models_discount.jsp?sid=3544&areaId=0&pageSize=20&pageNo=1 //定位
不到具体的城市或者所在城市无数据,则出省会的数据。如果省会也无数据,则出全国的数据
请求后端参数:
sid:车系id(从id_0取出)
pageNo:第几页
pageSize:每页显示多少条
2.7.6 顶踩接口
备注:对某个对象赞或者踩
请求URL:http://mdata.pcauto.com.cn/pcauto/user/ups-downs.jsp?id=4147099&type=1&action=1
HTTP请求方式:post
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:(说明:参数错误以及非post方法提交会返回400的status code)
id:112(文章、帖子或者图集id)
type:1( 类型id,1为文章、2为帖子或者3为图集)
action:3 (动作,1为‘顶’、2为‘踩’、3为‘取消顶’、4为‘取消踩’)
返回参数:
{
"id":123 // 文章、帖子或者图集id
"type":1, // 类型id,1为文章、2为帖子,3为图集
"resultCode":0, // 0表示成功,-1表示失败
"msg":"提示信息", // 提示信息
"ups":123, // 赞的数量
"downs":123 // 踩的数量
}
2.7.7 文章、帖子获取顶踩数
备注:获取某个对象的顶踩数
请求URL:http://mrobot.pcauto.com.cn/v3/cmt/getUpsDowns?params={"params":[{"id":4147099,"type":1}],"flag":1}
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:15分钟
请求参数:
params:此参数为json格式的字符串,具体格式如下:
{
"flag": 1,
"params":
[
{
"type": 1, //对象类型,1为文章;2为帖子;3为图集
"id": 3147444 //文章id、帖子id或者图集id
}
]
}
请求后端URL:
http://mdata.pcauto.com.cn/pcauto/user/ups-downs-list.jsp?params={"params":[{"id":4147099,"type":1}],"flag":1}
请求后端参数:
params:此参数为json格式的字符串,具体格式如下:
{
"flag": 1,
"params":
[
{
"type": 1, //对象类型,1为文章;2为帖子;3为图集
"id": 3147444 //文章id、帖子id或者图集id
}
]
}
2.7.8 评论推广
备注:获取评论的推广内容,由编辑在cms里维护
请求URL:http://mrobot.pcauto.com.cn/v3/bbs/commentExtend
HTTP请求方式:get
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:15分钟
请求参数:无
返回参数:
{
"data": [
{
"image": "http://xxxxxx",
"to-uri": "pcautobrowser://information-article/id"
}
]
}
请求后端URL:
http://www.pcauto.com.cn/client/news/tghd/1401/intf2887.js